Visual Studio Project File in ASP.NET Core

विजुअल स्टूडियो प्रोजेक्ट फाइल

इस लेख में हम विजुअल स्टूडियो के प्रोजेक्ट फाइल के संदर्भ में निम्नलिखित terms की व्याख्या करेंगे:

  1. Project
  2. PropertyGroup
  3. ItemGroup
  4. PackageReference
  5. ProjectReference
  6. Nullable
  7. ImplicitUsings

विजुअल स्टूडियो में प्रोजेक्ट फ़ाइलें (जो आमतौर पर .csproj, .vbproj, .fsproj एक्सटेंशन के साथ होती हैं) आपके प्रोजेक्ट को बनाने (build), डीबग (debug) और प्रकाशित (publish) करने के तरीके को नियंत्रित करती हैं. ये XML फ़ाइलें होती हैं जिनमें आपके प्रोजेक्ट के बारे में महत्वपूर्ण जानकारी होती है. आइए इन शब्दों को प्रोजेक्ट फ़ाइल के संदर्भ में समझते हैं:

Project (प्रोजेक्ट)

  • परिभाषा: .csproj (या .vbproj, .fsproj) फ़ाइल का मूल (root) तत्व. यह पूरी प्रोजेक्ट फ़ाइल को एनकैप्सुलेट करता है और एक MSBuild प्रोजेक्ट को परिभाषित करता है. MSBuild माइक्रोसॉफ्ट का बिल्ड प्लेटफ़ॉर्म है जो आपके कोड को संकलित (compile) करने और आउटपुट बनाने के लिए ज़िम्मेदार है.
  • कार्यक्षमता: Project तत्व के भीतर, आप प्रोजेक्ट के प्रकार (जैसे SDK-शैली प्रोजेक्ट), लक्ष्य फ़्रेमवर्क, निर्भरताएँ, फ़ाइलें, और अन्य सभी सेटिंग्स को कॉन्फ़िगर करते हैं.
  • उदाहरण:

<Project Sdk="Microsoft.NET.Sdk.Web"></Project>

  • यहां, Sdk="Microsoft.NET.Sdk.Web" बताता है कि यह एक वेब एप्लीकेशन प्रोजेक्ट है और .NET SDK के वेब-विशिष्ट बिल्ड टूल का उपयोग करेगा.

PropertyGroup (प्रॉपर्टी ग्रुप)

  • परिभाषा: PropertyGroup तत्व प्रोजेक्ट-व्यापी गुणों (project-wide properties) के संग्रह को परिभाषित करता है. ये गुण नाम-मूल्य जोड़े (name-value pairs) होते हैं जो बिल्ड प्रक्रिया के व्यवहार को प्रभावित करते हैं.
  • कार्यक्षमता: आप इन गुणों का उपयोग संकलन (compilation) विकल्प, लक्ष्य फ़्रेमवर्क, आउटपुट पथ, और विभिन्न सुविधाओं को सक्षम/अक्षम करने के लिए कर सकते हैं.
  • उदाहरण:

<PropertyGroup>

<TargetFramework>net8.0</TargetFramework>

<Nullable>enable</Nullable>

<ImplicitUsings>enable</ImplicitUsings>

<RootNamespace>MyWebApp</RootNamespace>

<OutputType>Exe</OutputType>

</PropertyGroup>

इस उदाहरण में:

  • TargetFramework: बताता है कि प्रोजेक्ट .NET 8.0 पर लक्षित है.
  • Nullable: नल संदर्भ प्रकारों (nullable reference types) को सक्षम करता है.
  • ImplicitUsings: निहित वैश्विक यूजिंग डायरेक्टिव्स (implicit global using directives) को सक्षम करता है.
  • RootNamespace: प्रोजेक्ट के लिए डिफ़ॉल्ट रूट नेमस्पेस को सेट करता है.
  • OutputType: बताता है कि आउटपुट एक निष्पादन योग्य (Exe) फ़ाइल होगी.

ItemGroup (आइटम ग्रुप)

  • परिभाषा: ItemGroup तत्व प्रोजेक्ट में शामिल या संदर्भ (reference) किए गए आइटमों के संग्रह को परिभाषित करता है. ये आइटम फ़ाइलें, पैकेज संदर्भ, प्रोजेक्ट संदर्भ आदि हो सकते हैं.
  • कार्यक्षमता: यह तत्व बताता है कि कौन सी फ़ाइलें प्रोजेक्ट का हिस्सा हैं, किन बाहरी पैकेजों की आवश्यकता है, या किन अन्य आंतरिक प्रोजेक्ट्स पर यह निर्भर करता है.
  • उदाहरण:

<ItemGroup>

<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="8.0.0" />

<ProjectReference Include="..\AnotherProject\AnotherProject.csproj" />

<Content Update="appsettings.json">

<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>

</Content>

</ItemGroup>

  • यहां, ItemGroup के भीतर, आप PackageReference, ProjectReference, और Content जैसे विभिन्न प्रकार के आइटम देखेंगे.

PackageReference (पैकेज संदर्भ)

  • परिभाषा: ItemGroup के भीतर एक तत्व जो NuGet पैकेज पर निर्भरता (dependency) को निर्दिष्ट करता है.
  • कार्यक्षमता: जब आप dotnet add package कमांड का उपयोग करते हैं या विजुअल स्टूडियो के NuGet पैकेज मैनेजर के माध्यम से एक पैकेज जोड़ते हैं, तो एक PackageReference प्रविष्टि प्रोजेक्ट फ़ाइल में जुड़ जाती है. यह .NET को बताता है कि बिल्ड के दौरान इस बाहरी लाइब्रेरी की आवश्यकता है.
  • उदाहरण:

<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="8.0.0" />

  • यह बताता है कि प्रोजेक्ट को Microsoft.EntityFrameworkCore.SqlServer NuGet पैकेज की आवश्यकता है, और इसका विशिष्ट संस्करण 8.0.0 होना चाहिए.

ProjectReference (प्रोजेक्ट संदर्भ)

  • परिभाषा: ItemGroup के भीतर एक तत्व जो समाधान (solution) के भीतर एक ही या किसी अन्य प्रोजेक्ट पर निर्भरता को निर्दिष्ट करता है.
  • कार्यक्षमता: जब आपका एक प्रोजेक्ट किसी दूसरे प्रोजेक्ट में परिभाषित क्लासेस या फंक्शन्स का उपयोग करता है (उदाहरण के लिए, एक वेब ऐप एक क्लास लाइब्रेरी में परिभाषित व्यावसायिक तर्क का उपयोग करता है), तो आप एक ProjectReference जोड़ते हैं. यह बिल्ड सिस्टम को यह सुनिश्चित करने के लिए बताता है कि संदर्भित प्रोजेक्ट को वर्तमान प्रोजेक्ट से पहले बनाया जाए.
  • उदाहरण:

<ProjectReference Include="..\MyDomain\MyDomain.csproj" />

  • यह इंगित करता है कि वर्तमान प्रोजेक्ट MyDomain.csproj नामक एक प्रोजेक्ट पर निर्भर करता है, जो समाधान में एक भाई-बहन के फ़ोल्डर (..\MyDomain) में स्थित है.

Nullable (नलेबल)

  • परिभाषा: एक PropertyGroup गुण जो नलेवल संदर्भ प्रकारों (Nullable Reference Types - NRTs) को सक्षम या अक्षम करता है.
  • कार्यक्षमता: .NET 6 (और बाद में) में पेश की गई एक सुविधा, NRTs कंपाइलर को यह विश्लेषण करने में मदद करती है कि क्या गैर-नलेवल संदर्भ प्रकारों को null असाइन किया जा सकता है. यह संभावित NullReferenceException त्रुटियों को कंपाइल-टाइम पर ही पकड़ने में मदद करता है, जिससे कोड की विश्वसनीयता बढ़ती है.
    • enable: नलेवल संदर्भ प्रकारों को पूरी तरह से सक्षम करता है. कंपाइलर null के साथ गैर-नलेवल संदर्भों को असाइन करने पर चेतावनी देगा.
  1. disable: नलेवल संदर्भ प्रकारों को अक्षम करता है (डिफ़ॉल्ट व्यवहार).
  2. warnings: केवल चेतावनी जारी करता है लेकिन त्रुटियां नहीं.
  3. annotations: केवल नलेवल संदर्भ प्रकारों के लिए ? और ! सिंटैक्स को सक्षम करता है, लेकिन कोई चेतावनी जारी नहीं करता.
  • उदाहरण:

<Nullable>enable</Nullable>

  • जब यह सक्षम होता है, तो कंपाइलर string name; को एक गैर-नलेवल स्ट्रिंग के रूप में मानता है, और name = null; पर चेतावनी देगा. आपको इसे string? name; के रूप में स्पष्ट रूप से नलेवल घोषित करना होगा.

ImplicitUsings (इम्प्लिसिट यूजिंग)

  • परिभाषा: एक PropertyGroup गुण जो SDK-शैली के प्रोजेक्ट्स में निहित वैश्विक यूजिंग डायरेक्टिव्स को सक्षम या अक्षम करता है.
  • कार्यक्षमता: .NET 6 (और बाद में) में पेश की गई एक और सुविधा, ImplicitUsings सामान्य नेमस्पेस को स्वचालित रूप से आपके कोड में उपलब्ध कराती है, बिना आपको प्रत्येक फ़ाइल में using स्टेटमेंट को स्पष्ट रूप से जोड़ने की आवश्यकता के. यह कोड को साफ और छोटा बनाता है.
    • enable: स्वचालित रूप से सामान्य नेमस्पेस को शामिल करता है (जैसे System, Collections.Generic, System.Linq कंसोल ऐप के लिए; ASP.NET Core ऐप के लिए अधिक).
    • disable: इस सुविधा को अक्षम करता है.
  • उदाहरण:

<ImplicitUsings>enable</ImplicitUsings>

  • इस सेटिंग के साथ, आपको using System; या using Microsoft.AspNetCore.Mvc; जैसी पंक्तियों को अपनी अधिकांश C# फ़ाइलों के शीर्ष पर जोड़ने की आवश्यकता नहीं होगी, क्योंकि वे कंपाइलर द्वारा स्वचालित रूप से शामिल की जाएंगी. यह विशेष रूप से नए .NET प्रोजेक्ट्स के लिए boilerplate कोड को कम करने में मदद करता है.

टिप्पणियाँ

एक टिप्पणी भेजें

इस ब्लॉग से लोकप्रिय पोस्ट

Differences between in-process and out-of-process hosting models

ASP.NET Core: इन-प्रोसेस और आउट-ऑफ-प्रोसेस होस्टिंग मॉडल में अंतर ASP.NET Core में सेल्फ-होस्टिंग मॉडल और आउट-प्रोसेस होस्टिंग मॉडल दो अलग-अलग तरीके हैं जिनका उपयोग आप अपने वेब एप्लिकेशन को होस्ट करने के लिए कर सकते हैं। सेल्फ-होस्टिंग मॉडल सेल्फ-होस्टिंग मॉडल में, ASP.NET Core एप्लिकेशन अपने आप में एक वेब सर्वर की भूमिका निभाता है। इसका मतलब है कि एप्लिकेशन अपने आप HTTP रिक्वेस्ट को सीधे हैंडल करता है और उन्हें प्रोसेस करता है। सेल्फ-होस्टिंग के लिए Kestrel नामक एक क्रॉस-प्लेटफ़ॉर्म वेब सर्वर का उपयोग किया जाता है। आउट-प्रोसेस होस्टिंग मॉडल आउट-प्रोसेस होस्टिंग मॉडल में, ASP.NET Core एप्लिकेशन एक अलग प्रोसेस में चलता है, और एक बाहरी वेब सर्वर (जैसे कि आईआईएस या एनजिनएक्स) HTTP रिक्वेस्ट को प्राप्त करता है और उन्हें एप्लिकेशन को फॉरवर्ड करता है। इस मॉडल में, एप्लिकेशन और वेब सर्वर अलग-अलग प्रोसेस में चलते हैं। अब इनके बारे में विस्तार से समझते हैं - 1. इन-प्रोसेस होस्टिंग (In-Process Hosting) कार...
Read more »

Web Fundamental Concepts in Hindi for Beginners - FAQs with their Answers Part-1

List of Consolidated Questions Question 1. वेब एप्लीकेशन को होस्ट करने की आवश्यकता होती है जबकि डेस्कटॉप एप्लीकेशन के साथ ऐसा नहीं होता है ऐसा क्यों? Question 2. वेब एप्लीकेशन को होस्ट करने के लिए एक वेब सर्वर की जरूरत होती है क्यों? इसके अलावा वेब एप्लीकेशन को डाटाबेस सर्वर की भी आवश्यकता पड़ती है क्यों? Question 3. वेब सर्वर के अलावा और किन-किन प्रकार के सर्वर की आवश्यकता वेब एप्लीकेशन को पड़ती है? Question 4. एक वेब एप्लीकेशन को एक से अधिक सर्वर पर कई बार क्यों होस्ट किया जाता है? Question 5. वेब एप्लीकेशन और वेब सेवा में क्या अंतर है या दोनों एक ही चीज है? Question 6. क्या यह सच है कि एक वेब एप्लीकेशन एक या एक से अधिक वेब सेवाओं का उपयोग कर सकता है? Question 7. वेब एप्लीकेशन के संदर्भ में गेटवे क्या होता है? Question 8. ...
Read more »

Introduction to ASP.NET Core and Web Frameworks

वेब एप्लीकेशन और .NET Core का परिचय वेब एप्लीकेशन हर जगह उपलब्ध हैं, चाहे वह सोशल मीडिया हो या आपका फ़ोन; हर जगह आपको वेब एप्लीकेशन दिखाई देंगे। वेब एप्लीकेशन के पीछे की दुनिया सर्वर की दुनिया है। सर्वर पर कोई वेब एप्लीकेशन होस्ट किया जाता है, तत्पश्चात वेब एप्लीकेशन रन होता है। .NET Core को आधुनिक युग की आवश्यकताओं के अनुसार डिज़ाइन किया गया है। चाहे कोई साधारण सा वेबसाइट हो या कोई जटिल ई-कॉमर्स एप्लीकेशन अथवा डिस्ट्रीब्यूटेड माइक्रो सर्विसेज, एक बार जब आप .NET Core सीख जाते हैं तो इस तरह के कोई भी एप्लीकेशन आप बना सकते हैं। अब सवाल है कि .NET Core क्या है? ASP.NET Core माइक्रोसॉफ्ट का नया वेब फ्रेमवर्क है जिसकी सहायता से विभिन्न प्रकार के वेब एप्लीकेशन को बनाना बहुत ही सरल है। माइक्रोसॉफ्ट ने ASP.NET Core को जून 2016 में रिलीज़ किया था। इसके बाद निरंतर माइक्रोसॉफ्ट की टीम ने .NET Core में सुधार करके या अपग्रेड करके बाजार में नए-नए वर्जन जारी किए हैं. वेब फ्रेमवर्क क्या है? ...
Read more »